home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / a_man / cat1 / dhcpdb.z / dhcpdb
Encoding:
Text File  |  2001-04-17  |  7.4 KB  |  199 lines

  1.  
  2.  
  3.  
  4. ddddhhhhccccppppddddbbbb((((1111MMMM))))                                                          ddddhhhhccccppppddddbbbb((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      dhcpdb - DHCP database manager
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ////uuuussssrrrr////ssssbbbbiiiinnnn////ddddhhhhccccppppddddbbbb [ ----aaaa [ ----rrrr] ] | [ ----dddd ] | [ ----uuuu ] | [ ----pppp ] [ ----XXXX ]
  13.      [ ----CCCC CCCClllliiiieeeennnntttt____iiiidddd  ] [ ----MMMM MMMMaaaacccc____aaaaddddddddrrrreeeessssssss ] [  ----IIII IIIIPPPP____aaaaddddddddrrrreeeessssssss ]
  14.      [  ----HHHH hhhhoooossssttttnnnnaaaammmmeeee ] [ ----TTTT lllleeeeaaaasssseeee____iiiinnnn____sssseeeeccccoooonnnnddddssss  ] [ ----ffff ddddhhhhccccpppp____ddddaaaattttaaaabbbbaaaasssseeee ]
  15.  
  16.      ////uuuussssrrrr////ssssbbbbiiiinnnn////ddddhhhhccccppppddddbbbb [  ----DDDD ] | [ ----LLLL ] [ ----XXXX ] [ ----ffff ddddhhhhccccpppp____ddddaaaattttaaaabbbbaaaasssseeee ]
  17.  
  18. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.      _d_h_c_p_d_b is a database manager for the NDBM database used by the DHCP
  20.      server to store address leases. It provides a command line interface to
  21.      add, delete, update, or print the DHCP database.
  22.  
  23.      The tool can be used either in entry mode to manipulate individual
  24.      entries or in file mode. In file mode the entire contents of the database
  25.      can be dumped to a file or loaded from a file.
  26.  
  27.  
  28. CCCCOOOOMMMMMMMMAAAANNNNDDDD LLLLIIIINNNNEEEE OOOOPPPPTTTTIIIIOOOONNNNSSSS
  29.      In the entry mode options can be used to add (replace), delete, update a
  30.      lease, or print an entry using a key. The key can be either a client
  31.      identifier, MAC (interface) address, IP address, or a hostname.
  32.  
  33.      ----aaaa   Add an entry. The ----rrrr option allows an existing entry to be replaced
  34.           or a new entry is added if the specified entry does not exist. The
  35.           client identifier, Mac address, IP address, and hostname must be
  36.           specified. If a record is being replaced these values must be
  37.           specified to be the same as existing values in the database. The
  38.           lease time should also be specified.
  39.  
  40.      ----dddd   Delete an entry. A single key in the form of client identifier, Mac
  41.           address, IP address, or hostname should be specified.
  42.  
  43.      ----uuuu   Update lease time. Specify a key and the lease time using the ----TTTT
  44.           option.
  45.  
  46.      ----pppp   Print an entry for the given key. This can also be used to print
  47.           leases expiring in more or less than a specified number of seconds.
  48.  
  49.      ----XXXX   Specifies that the client identifier is a colon separated string of
  50.           bytes in hexadecimal in the specified input or in the output. If
  51.           this option is not specified the client identifier is assumed to be
  52.           a string.
  53.  
  54.      ----CCCC _C_i_d
  55.           Specifies the client identifier key.
  56.  
  57.      ----MMMM _M_a_c__a_d_d_r_e_s_s
  58.           Specifies the Mac (physical interface) address as a string of bytes
  59.           in hexadecimal, separated by colons.
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ddddhhhhccccppppddddbbbb((((1111MMMM))))                                                          ddddhhhhccccppppddddbbbb((((1111MMMM))))
  71.  
  72.  
  73.  
  74.      ----HHHH _H_o_s_t_n_a_m_e
  75.           This is the hostname (usually fully qualified) as it appears in the
  76.           database.
  77.  
  78.      ----IIII _I_P _a_d_d_r_e_s_s
  79.           Specifies the IP address as a dotted decimal address string.
  80.  
  81.      ----TTTT  _l_e_a_s_e__s_e_c_o_n_d_s|_a_b_s_o_l_u_t_e _t_i_m_e
  82.           Specifies the lease time in seconds. With the ----pppp option the lease
  83.           time can be specified to print the leases that expire in less than
  84.           or greater than a given number of seconds from the current time. For
  85.           example -_p -_T <_1_0_0, and -_p -_T >_1_0_0 prints leases expiring in less
  86.           than 100 seconds and more than or equal to 100 seconds respectively.
  87.           The format -_T "_s_e_c[_0-_6_1] _m_i_n[_0-_5_9] _h_o_u_r[_0-_2_3] _m_d_a_y[_1-_3_1] _m_o_n[_0-_1_1]
  88.           _y_e_a_r_s__s_i_n_c_e__1_9_0_0" can also be used to specify the time when adding
  89.           or updating an entry. For example -T "10 12 20 18 4 98" means the
  90.           lease should expire on May 18 21:12:10 1998. The format is the same
  91.           as is used with the mmmmkkkkttttiiiimmmmeeee(3C) call. Alternately -_T _s_e_c_o_n_d_s can be
  92.           used to specify the time in seconds from 00:00:00 UTC, January 1,
  93.           1970 (see _t_i_m_e(2)). For example in the particular case discussed
  94.           above the option would be specified as -_T _8_9_5_5_5_1_1_3_0.
  95.  
  96.           With the -_a and -_u options the lease can be specified as IIIINNNNFFFF for an
  97.           infinite lease or as SSSSTTTTAAAATTTTIIIICCCC for a static (infinite) lease. For
  98.           example, to make an existing lease for address 10.0.10.1 static the
  99.           command is _d_h_c_p_d_b -_I _1_0._0._1_0._1 -_u -_T _S_T_A_T_I_C.
  100.  
  101.      ----ffff   Specifies an alternate database to use. The default is
  102.           /_v_a_r/_d_h_c_p/_e_t_h_e_r_T_o_I_P.
  103.  
  104.    FFFFiiiilllleeee mmmmooooddddeeee uuuussssaaaaggggeeee
  105.      In the file mode the command can be used to dump the entire database to a
  106.      file that can be subsequently loaded into the database.
  107.  
  108.      ----DDDD   Dumps the database to the standard output. The file consists of
  109.           fields separated by tabs and includes the client identifier, Mac
  110.           address, IP address, hostname, and the lease time.
  111.  
  112.      ----LLLL   Loads the database from the standard input.
  113.  
  114.  
  115. NNNNOOOOTTTTEEEESSSS
  116.      The /_e_t_c/_e_t_h_e_r_s and /_e_t_c/_h_o_s_t_s are not updated when the DHCP
  117.      /_v_a_r/_d_h_c_p/_e_t_h_e_r_T_o_I_P database is updated.
  118.  
  119. FFFFIIIILLLLEEEESSSS
  120.      /var/dhcp/etherToIP.lock
  121.      /var/dhcp/etherToIP.pag
  122.      /var/dhcp/etherToIP.dir
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ddddhhhhccccppppddddbbbb((((1111MMMM))))                                                          ddddhhhhccccppppddddbbbb((((1111MMMM))))
  137.  
  138.  
  139.  
  140. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  141.      dhcp_server(1M) ProclaimServerMgr(1M),
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.